usually

usually

Usually Will Generate Usage Of Node.JS Command-Line Applications. It is compatible with Argufy which can save arguments in the arguments.xml file, and extract them with auto-generated JavaScript compatible with Google Closure Compiler.

yarn add -E usually

Table Of Contents

• Table Of Contents
• API
• usually(config: Config): string
  • _usually.Config
• Argufy Integration
• Copyright

API

The package is available by importing its default function:

import usually from 'usually'

The types and externs for Google Closure Compiler via Depack are defined in the _usually namespace.

usually(
  config: Config,
): string

Create a string to display as a help message.

_usually.Config: The configuration object.

Name	Type	Description
usage*	!Object<string, string>	The map with possible arguments (flags, options) and their information.
description	string	What does the program do?
line	string	The summary of the program in one line.
example	string	The example of the program usage.

import usually from 'usually'

const res = usually({
  usage: {
    '-h': 'print help',
    '-c': 'execute this command',
  },
  description: 'A test command-line application',
  line: 'usually [-c command|command2] [-h]',
  example: 'usually -c command2',
})

console.log(res)

A test command-line application

  usually [-c command|command2] [-h]

	-h	print help
	-c	execute this command

  Example:

    usually -c command2

---

The algorithm will tab the usage object and all new lines will appear indented to the required padding.

import usually from 'usually'

const res = usually({
  usage: {
    '-h': 'print help',
    '-c': `execute this command, that will perform
the operations on the CPU and return result
upon the full execution or terminate after
30s of inactivity.`,
  },
  description: 'Run the usually',
})

Run the usually

	-h	print help
	-c	execute this command, that will perform
	  	the operations on the CPU and return result
	  	upon the full execution or terminate after
	  	30s of inactivity.

Argufy Integration

Argufy is a program that manages arguments for CLI programs by storing them in a separate XML file so that they are readily updatable in both source code and README documentation. It also generates the script that extracts those arguments and works with Google Closure Compiler. Read More.

Copyright

(c) Art Deco 2019

Changelog

1.2.0

• [externs] Generate externs for Google Closure Compiler via Depack withing `usually namespace.
• [doc] Doc integration with Argufy.
• [deps] Update and unlock dev dependencies.
• [package] Export module.

4 Dec 2018